v4.2.2: Koin 4.2.2

Compare Source

Maintenance release for the 4.2.x line — resolver regression fixes from the 4.2.0 CoreResolverV2 rewrite, ViewModel/scope fixes, a Ktor request-scope fix, plus new tvOS support and an R8/ProGuard guide.

Anyone hitting resolver issues on 4.2.0/4.2.1 should upgrade to 4.2.2.

Bug Fixes

• Stacked params no longer shadow qualified dependencies (#​2370, #​2408) — A value passed via parametersOf could be returned for a get(named(...)) request of the same type, shadowing the qualified definition. Qualified lookups are now registry-only and never read the parameter stack — parameters carry no qualifier, so they can't satisfy a qualified request.

• Root factory no longer resolves its scoped dependencies from _root_ (#​2379) — When a non-single factory defined in the root scope was resolved from a child scope, CoreResolverV2 resolved its scoped dependencies against _root_ instead of the requesting scope. Linked-scope resolution now runs the factory against the requesting scope (single instances keep their root-bound semantics, preserving #​2325).

• viewModelScopeFactory scope is linked to its parent (#​2299) — A ViewModel scope created via viewModelScopeFactory() was not linked to the originating scope, so dependencies declared in the parent couldn't be resolved. The created scope is now linked to its parent (except when the parent is root).

• Tolerate non-String environment properties (#​2348) — Loading environment/system properties whose values aren't String threw ClassCastException due to an unchecked map cast. Non-String values are now preserved as Any and only String keys are required.

• Unique Ktor request-scope ids under concurrency (#​2410) — Concurrent requests could collide on request-scope ids. Ids are now generated from a monotonic counter seeded once at startup. Thanks @​lfavreli-betclic!

• Actionable errors for SavedStateHandle / viewModelScope { } (#​2044, #​2417) — Resolving SavedStateHandle without the proper extras, or using viewModelScope { } without the viewModelScopeFactory() option, now produces a clear, actionable error message instead of an opaque failure.

Added

• tvOS targets for koin-core-viewmodel (#​2426) — koin-core-viewmodel now publishes tvosArm64, tvosX64, and tvosSimulatorArm64, unblocking ViewModel usage on tvOS.

• Consumer R8/ProGuard rules + guide — Android and ViewModel artifacts now ship consumer R8/ProGuard rules in their AARs, and a new R8 / ProGuard guide documents keep rules for minified builds.

Improvements

• O(1) secondary-type registration in bind() / binds() — bind/binds now append secondary types in O(1) instead of reallocating the type list per binding, removing quadratic cost when a definition declares many bindings. No user-visible behavior change.

Documentation

• Navigation 3 typed entryProvider (#​2336) — Added guidance on using Koin with the typed entryProvider in the Navigation 3 reference.

Contributors

Thanks to the following contributors for this release:

• @​arnaudgiuliani (Arnaud Giuliani)
• @​lfavreli-betclic (Loïc Favrelière) — unique Ktor request-scope ids under concurrency (#​2432)

v4.2.1: Koin 4.2.1

Compare Source

Support for Compile Safety with Koin Compiler 1.0.0-RC1

• Koin Compiler Plugin 1.0.0-RC1 - https://github.com/InsertKoinIO/koin-compiler-plugin/releases/tag/1.0.0-RC1

Bug Fixes

• Fix stacked-params lookup on linked scopes (#​2387) — The 4.2.0 resolver rewrite (CoreResolverV2) walked linked scopes but dropped the per-parent stacked-parameters check that 4.1.x performed via recursion. This broke patterns where AndroidParametersHolder is stacked on the factory scope by KoinViewModelFactory and SavedStateHandle is then resolved from a child ViewModel scope. Linked-scope resolution now also checks stacked params on each parent scope.

• Restore ABI compatibility for runOnKoinStarted (#​2391) — The 4.2.0 release inadvertently broke binary compatibility for runOnKoinStarted on JVM. Fixed by restoring the original JVM class name via @JvmName/@JvmMultifileClass annotations.

• Fix scope _closed concurrency issue (#​2389) — The Scope._closed flag was not volatile, which could cause stale reads under concurrent access.

Improvements

• Improved Scope resolution error messages — CoreResolverV2 now provides clearer error messages when scope resolution fails, making it easier to diagnose misconfigured scopes.

• Added apiCheck to CI — Binary compatibility validation (kotlinx.binary-compatibility-validator) now runs on every PR to prevent future ABI breaks.

Documentation

• parametersOf type-collision warning (#​2328) — Added a caution note explaining that when a value passed via parametersOf has the same type as the requested definition, Koin returns the value directly and skips the factory block. Suggests using a wrapper type as a workaround.

Contributors

Thanks to the following contributors for this release:

• @​arnaudgiuliani (Arnaud Giuliani)
• @​inemtsev (Ilya Nemtsev) — fix for scope closed concurrency issue (#​2389)

v4.2.0

Compare Source

Kotlin 2.3.20

New Features

• Ktor 3.4 DI Bridge — Full integration with Ktor's new DI system (ktor-server-di), bridging Ktor ↔ Koin dependency injection both ways
• Dagger Bridge (koin-dagger-bridge) — New module to help inject Koin components from Dagger side
• AndroidX Navigation 3 support — Entry point provider with metadata parameter passing (animations, etc.), generic EntryProvider, and navigation scopes
• Navigation Scope for Compose Nav 2 — Added scoped navigation support for Compose Navigation 2
• Lazy Modules — Parallel loading at startup for improved performance, with benchmarks
• strictOverride option — New definition option to override explicitly
• koinActivityInject — Helper to retrieve dependencies against Activity scope
• Koin Compiler Stubs — Added stubs for KoinApplication.modules() functions
• KoinApplication.withConfiguration() — New configuration support

Performance & Stability

• Core Resolver V2 — Fixed parameter stack propagation, injected params handling, and child scope/ViewModel scope resolution
• Scope Resolution & Thread Safety — Performance optimization with safer ScopeFactory protecting all operations from parallel calls
• ThreadLocal loading optimization — Avoid cost per Scope (#​2306)
• getAll no longer sorted by default — Instances come as declared; sort on purpose if needed
• Params stack access optimization

Bug Fixes

• Fix sharedKoinViewModel with type-safe navigation routes (#​2293)
• Fix qualified name usage in WASM (#​2312)
• Fix premature release of scope & context in Compose — don't drop in onForgotten (#​2274)
• Fix crashing declarations for LocalKoinScope & LocalKoinApplication
• Fix Compose Koin Context Loader and Entry Points (#​2327)
• Fix CoreResolution with Child Scopes / ViewModelScope (#​2325)
• Fix Scope Archetypes Qualifier in plugin support functions
• Fix qualifier conversion

Breaking Changes

• minSdk raised to 23 for Android
• module renamed to lazyModule in some contexts
• BeanDef constructor change (API signature update)

Dependencies

• Kotlin 2.3.20
• Ktor 3.4
• JetBrains Compose 1.10.2
• AndroidX Lifecycle 2.10.0
• AndroidX Navigation 2.9.7 / Nav3 1.0.1

v4.1.1

Compare Source

Koin 4.1.1 Changelog

🐛 Bug Fixes

• Logger Constraint Revert - Reverted logger constraint due to compatibility issues causing errors across projects
• Maven Central Publication - Fixed publication issues for Maven Central distribution

💥 Breaking Changes for Internal

• Compose Scope Resolution - Fixed scope resolution issues in Compose integration with proper context handling, introduced ComposeContextWrapper to help manage internal scope state

🚀 Features & Improvements

• Compose ViewModel Navigation - Added optional navGraphRoute parameter to sharedKoinViewModel for better navigation support
• Compose Context Handling - Reworked LocalKoinApplication/LocalKoinScope with ContextWrapper to properly handle:
  • Scope closing lifecycle
  • Context restart scenarios
  • Better memory management

⚡ Performance & Core

• Core Resolver Optimization - Avoid unnecessary flattening operations when dealing with single scope resolution
• Scope Debugging - Enhanced scope debugging by showing linked scope IDs for better development experience
• Library Updates - Updated underlying dependencies to latest stable versions

📚 Library Updates

• Kotlin - Updated to 2.1.21 (from 2.1.20)
• Binary Validator - Updated to 0.18.1 (from 0.16.3)
• Ktor - Updated to 3.2.3 (from 3.1.3)
• Jetbrains Compose - Updated to 1.8.2 (from 1.8.0)
• AndroidX Libraries:
  • Fragment 1.8.9 (from 1.8.8)
  • WorkManager 2.10.3 (from 2.10.1)
  • Lifecycle 2.9.3 (from 2.9.0)
  • Navigation 2.9.3 (from 2.9.0)
  • JB Navigation RC01 (from Beta01)
• Testing:
  • Robolectric 4.15.1 (from 4.14.1)
  • Benchmark 0.4.14 (from 0.4.13)
• Build Tools - Added NMCP 1.1.0 for improved publication workflow

📦 Publication

• Multi-platform Artifacts - Ensured all platform variants are properly published
• Version Consistency - Synchronized all module versions across the ecosystem

🔧 Development

• Test Coverage - Added ActivityScopeArchetypeTest for better scope lifecycle testing
• API Stability - Maintained backward compatibility while fixing internal issues

👥 Contributors

https://github.com/arnaudgiuliani - Project Lead & Core Developer
https://github.com/rfaturriza - Community Contributor

New Contributors

• @​rfaturriza made their first contribution in #​2262

Full Changelog: InsertKoinIO/koin@4.1.0...4.1.1

v4.1.0

Compare Source

What's Changed

• Add Ktor3 Package by @​chrisjenx in #​1978
• Ktor requestscope function dsl by @​arnaudgiuliani in #​2075
• KoinApplication Multiplatform Config - Logger + Androic context automatic injection by @​arnaudgiuliani in #​2086
• [Maintenance] Github actions migrations by @​GrzegorzBobryk in #​2109
• KoinMultiplatformApplication - Compose Application Start + Native Context binding by @​arnaudgiuliani in #​2114
• Fix koininject signature by @​arnaudgiuliani in #​2154
• Wasm use std UUID by @​arnaudgiuliani in #​2159
• Feat - scope archetypes for Activity, Fragment & ViewModel by @​arnaudgiuliani in #​2169
• Feat - Shared ViewModel in navigation by @​arnaudgiuliani in #​2170
• remove toolchain param + gradle 8.9 + remove unused deps by @​arnaudgiuliani in #​2172
• Update Compose Multiplatform to 1.8.0-rc01 by @​zsmb13 in #​2179
• check optional parameters during dependency verification by @​luozejiaqun in #​2105
• Feat - AutoCloseable usage for VM Scope closure + ViewModel Scope creation at VM Factory (ctor injection) + Options activation by @​arnaudgiuliani in #​2181
• Feat - New Compose Preview function to help local preview with parallel … by @​arnaudgiuliani in #​2182
• Continue Compose Multiplatform 1.8 version upgrade by @​zsmb13 in #​2183
• Migration to lifecycle 2.9 by @​MatkovIvan in #​2184
• [CI] Introduce reusable action for job initialization by @​GrzegorzBobryk in #​2110
• [Maintenance] removal of @OptIn and @Suppress by @​GrzegorzBobryk in #​1996
• Fix - 4.1.0 beta8 build by @​arnaudgiuliani in #​2185
• [Feat] Module Configuration + lazy modules verification (global configuration consistency) + Verification API updates by @​arnaudgiuliani in #​2188
• [Merge] koin-ktor3 to koin-ktor by @​arnaudgiuliani in #​2190
• Add missing minSdk config for koin-compose-viewmodel modules by @​zsmb13 in #​2192
• Fix lib setup for android manifest + withJava by @​arnaudgiuliani in #​2193
• [Feat] Ktor 3.2 DI extension for Koin (Ktor EAP) by @​arnaudgiuliani in #​2196
• [Feat] Make ktor usable in Multiplatform (Ktor EAP) by @​arnaudgiuliani in #​2197
• [merge] ktor 3.2 eap integrations by @​arnaudgiuliani in #​2198
• [Maintenance] Clean up in AndroidManifest.xml files by @​GrzegorzBobryk in #​2191
• Fix Compose rotation/Koin application setup & reattached Koin instance by @​arnaudgiuliani in #​2206
• Add koinActivityViewModel to help inject ViewModel for Activity by @​arnaudgiuliani in #​2207
• Fix #​2092 by adding an explicit JVM target for bom by @​arnaudgiuliani in #​2208
• Fix override create at start by @​arnaudgiuliani in #​2211
• Fix typo by @​samet404 in #​2149
• Fix different typos in docs. by @​zainulhassan815 in #​2144
• Fix misspelling in android.md by @​evansmj in #​2137
• Update dsl.md by @​BdN3504 in #​2131
• Removed usages of old "compile" gradle dependency configuration in docs by @​k4k7us23 in #​2123
• Update scope.md by @​AlexBeggs in #​2102
• Update scope.md by @​AlexBeggs in #​2101
• Update scopes.md by @​AlexBeggs in #​2100
• fix break links in start-koin.md by @​synix in #​2057
• update KoinExtension interface in doc by @​synix in #​2056
• [documentation] Fix link to junit5 extensions in testing.md by @​Calfur in #​1745
• Downgrade to Ktor 3.1 - Keep 3.2 for next patch by @​arnaudgiuliani in #​2224
• Feat - Extend Ktor DI support by @​arnaudgiuliani in #​2212
• fix workmananger initialization to avoid re-init + add android test by @​arnaudgiuliani in #​2226

New Contributors

• @​chrisjenx made their first contribution in #​1978
• @​luozejiaqun made their first contribution in #​2105
• @​MatkovIvan made their first contribution in #​2184
• @​samet404 made their first contribution in #​2149
• @​zainulhassan815 made their first contribution in #​2144
• @​evansmj made their first contribution in #​2137
• @​BdN3504 made their first contribution in #​2131
• @​k4k7us23 made their first contribution in #​2123
• @​AlexBeggs made their first contribution in #​2102
• @​synix made their first contribution in #​2057
• @​Calfur made their first contribution in #​1745

Full Changelog: InsertKoinIO/koin@4.0.4...4.1.0